home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / p / portfoli / pgc / pgedit.doc < prev    next >
Encoding:
Text File  |  1996-10-30  |  9.2 KB  |  277 lines
  1.  
  2.  
  3.     PGEDIT - The Atari Portfolio Graphics Editor
  4.     Version 1.1 (Dated 1/13/91 - 38141 bytes)
  5.     Copyright (c)1991 Software Vineyard  All Rights Reserved
  6.     by Don Messerli
  7.  
  8.     This program is public domain.  It may not be resold
  9.     alone or as part of any other package without prior
  10.     consent.
  11.  
  12.     New Features
  13.     ------------
  14.  
  15.     Support for PGC (compressed files), see below.
  16.     Now supports EGA as well as VGA !!
  17.     Print Shop image import
  18.     PGSHOW no longer included in this archive file
  19.  
  20.     Description
  21.     -----------
  22.  
  23.     PGEDIT allows you to create, edit, and modify PGC graphic
  24.     files for use on the Atari Portfolio.
  25.  
  26.     NOTE: The PGF file format has been replaced with the PGC
  27.     (compressed) format.  This new format allows images to be
  28.     compressed to save disk (ram card) space.  Typical compression
  29.     creates files from 20 to 70% of their original size.
  30.  
  31.     This version of PGEDIT will load PGF or PGC files, with PGC
  32.     being the default.  It will not let you save a file in PGF
  33.     format anymore.
  34.  
  35.     The PGC format is the preferred format because of it's space
  36.     savings.  However, some future utilites and programs will only
  37.     output PGF format files.  That's a decision the program's
  38.     author has to make.  If you end up with PGF format files, they
  39.     can easily be converted to PGC format by loading them into
  40.     PGEDIT and immediately saving them back to disk.  They can also
  41.     be converted with PGCOMP.EXE by Software Vineyard.
  42.     
  43.     PGC files can be viewed on the Portfolio with:
  44.     
  45.     PGSHOW.EXE 1.10 (c)1990 Software Vineyard
  46.  
  47.     PGC files can be shown, loaded or saved with PBASIC 3.1.
  48.     (PBASIC is (c)1990 BJ Gleason)
  49.  
  50.     Old PGF files can be viewed on the Portfolio with:
  51.  
  52.     PGSHOW.EXE 1.00 (c)1990 Software Vineyard
  53.     PGF.COM        (c)1990 BJ Gleason
  54.  
  55.     PGEDIT runs under it's own graphical user interface and thus
  56.     requires a mouse and VGA card. (See System Requirements below)
  57.     The user interface is very simple to use.  All actions are
  58.     performed by clicking on a "button" on the screen.  This
  59.     version of PGEDIT has many features.  It is lacking in
  60.     the area of drawing tools.  There are no box, line, or circle
  61.     drawing tools.  There is also no cut and paste.  These features
  62.     will be addressed in a future version.
  63.  
  64.     There are quite a few picture manipulation features.  These
  65.     include Reverse image, center horizonally/vertically, flip
  66.     horizontally/vertically, and move one pixel up/down/left/right.
  67.  
  68.     For those who don't want to start with a blank slate, PGEDIT
  69.     also allows you to import a piece of a MacPaint file or a Print
  70.     Shop image.  Future versions will also support importing from IMG,
  71.     PCX, GIF, and TIFF files.
  72.  
  73.     System Requirements
  74.     -------------------
  75.  
  76.     PGEDIT does not run on the Atari Portfolio!!!
  77.  
  78.     PGEDIT requires an IBM compatible running DOS 3.1 or higher
  79.     with 512 K of memory (360 K free), EGA or VGA graphics card, and
  80.     a Microsoft compatible mouse.
  81.  
  82.     This program does not require a hard drive.  It will run
  83.     from a single 360K floppy drive with no problem (albeit slowly).
  84.  
  85.     Using the program
  86.     -----------------
  87.  
  88.     Turning dots on and off
  89.  
  90.     Toggle dots on and off by clicking in the large grid. The
  91.     large grid represents 1/5 of the complete image width.
  92.     It shows the complete image height at all times.  The 5
  93.     sections of the image are referred to as panes in this manual.
  94.     
  95.     Moving from pane to pane
  96.  
  97.     There are two ways to move from pane to pane.  The five buttons
  98.     numbered 1 2 3 4 5 can be clicked on.  The current pane number is
  99.     black in color.  You can also click in the thumbnail sketch
  100.     of the complete image (located in the lower left corner of
  101.     the screen).  You will not move to the exact dot on the grid
  102.     you click on, just the pane that dot is in.  There are light
  103.     blue hash marks under the thumbnail sketch to show where
  104.     the panes lie.
  105.  
  106.     Clicking on a button doesn't seem to do anything!
  107.  
  108.     If you click on a button and it doesn't seem to do anything,
  109.     try clicking on it again.  Whenever you click on a button,
  110.     the mouse pointer should disappear while the action is being
  111.     performed.
  112.  
  113.     What do all the buttons do?
  114.     ---------------------------
  115.  
  116.     NEW    Clears the grid for work on a new image.  PGEDIT
  117.         doesn't currently ask you whether you are sure
  118.         you want to do this.  See the UNDO feature description.
  119.  
  120.     LOAD    Load an existing image from disk.  You don't have
  121.         to include the .PGF extension.  It is the default.
  122.         There are only enough characters for the filename
  123.         and extension, so it must be in the current
  124.         directory.  A much better file requester will show
  125.         up in a future version.
  126.  
  127.         If you decide not to load an image, just press the
  128.         ESC key.  
  129.  
  130.     SAVE    Save the current image to disk.  The last filename
  131.         loaded is the default.  If you don't include an
  132.         extension of the filename, a .PGF will be appended.
  133.  
  134.         If you decide not to save the image, just press the
  135.         ESC key.
  136.  
  137.     QUIT    Leave PGEDIT.  You will NOT be asked if you are sure
  138.         or if you want to save the current image.
  139.  
  140.     IMPORT    Import from a MacPaint or Print Shop file.  A dialog box
  141.         will appear asking what type of file you wish to import
  142.         from.  Click on the appropriate button or click on the
  143.         CANCEL button if you don't wish to import anything.
  144.  
  145.         Mac Paint Import
  146.         ----------------
  147.         You will be asked for the name of the MacPaint file.
  148.         If you leave off the extension, .MAC is assumed.  
  149.  
  150.         The picture is presented in a window.  Use the arrow
  151.         keys to put the part of the picture you want to import
  152.         inside the red box.  Press RETURN.  I know this box is small.
  153.         So is the Portfolio's screen.
  154.  
  155.         The home, end, page-up, page-down, ctrl-left, and ctrl-right
  156.         move in bigger increments.
  157.  
  158.         If you decide not to import the image, just press
  159.         the ESC key.
  160.  
  161.         Print Shop Import
  162.         -----------------
  163.         You will be asked for the name of the Print Shop file.
  164.         If you leave off the extension, .DAT is assumed.  If you
  165.         have image files specifically for "The New Print Shop",
  166.         they must have a .PNG extension or they won't be handled
  167.         properly.
  168.  
  169.         The Print Shop images are presented five at a time in a
  170.         window.  Move the red box with the arrow keys to choose
  171.         which image to import.  Press RETURN to import it.  The
  172.         image will be centered in the grid.
  173.  
  174.         The home, end, page-up, page-down, ctrl-left, and ctrl-right
  175.         move in bigger increments.
  176.  
  177.         If you decide not to import an image, just press the ESC
  178.         key.
  179.  
  180.     REV    Reverse the image.  Changes white dots to black and
  181.         vice-versa.
  182.  
  183.     U D L R    These buttons move the picture inside the grid by
  184.         one pixel in the specified direction.  U for Up,
  185.         D for Down, L for Left, R for Right.  If any dots
  186.         "fall off" the edge of the grid, they are lost.
  187.         Creative use of the UNDO button (press it!) will
  188.         pick those dots up off of the inside of your monitor
  189.         and glue them back on the screen.
  190.  
  191.     FLIPH    Flip the image horizontally, as if holding it up
  192.         to a mirror.
  193.  
  194.     FLIPV    Flip the image vertically, as if hanging upside down
  195.         from your ceiling.
  196.  
  197.     Ctr H    Center the image in the grid horizontally.  This
  198.         figures out the furthest left dot and the furthest
  199.         right dot and then center the image from left to
  200.         right.
  201.  
  202.     Ctr V    Center the image vertically in the grid.  This
  203.         figures out the top and bottom dots and centers
  204.         the image from top to bottom.
  205.  
  206.     VIEW    View the image at 200% of it's normal size.  Good for
  207.         seeing that fine detail that you won't see on the
  208.         Portfolio's screen anyway.  Click the mouse button
  209.         or press a key to continue.
  210.  
  211.     UNDO    Undoes the last action you performed.  If all you
  212.         did was toggle a dot on or off, this button will
  213.         not undo it.  Some actions can, of course, be undone
  214.         by clicking on other action buttons. (i.e. FLIPV)
  215.  
  216.     ABOUT    Copyright information about PGEDIT.  Also contains
  217.         version number you are using!
  218.  
  219.     HELP    Gives very brief descriptions of all the buttons.
  220.  
  221.     
  222.     What are these other files included with PGEDIT
  223.     -----------------------------------------------
  224.  
  225.     6 PGC graphic files are included to experiment on.
  226.     GORBY.PGC    Gorbachev
  227.     USA.PGC        Map of the U.S.
  228.     SPIRAL.PGC    A rectangular spiral
  229.     PORTF.PGC    The Portfolio Logo
  230.     FUJI.PGC    Atari Logo
  231.     BOMB.PGC    A bomb with fuse lit
  232.  
  233.  
  234.     Revision History
  235.     ----------------
  236.     
  237.     Version 1.1 - 1/13/91
  238.     - Added support for loading and saving in PGC (compressed) format.
  239.       This is now the default.  
  240.     - All files saved in PGC format only.
  241.     - Added support for EGA.
  242.     - Added Print Shop import.
  243.     - PGSHOW no longer included in archive.
  244.  
  245.     Version 1.00 - 12/25/90
  246.         Initial Release
  247.  
  248.     A note from the author
  249.     ----------------------
  250.  
  251.     Have fun with it.  I know it's not perfect.  I will be adding
  252.     more features and fixing any problems that pop up on a regular
  253.     basis.  If you have ideas (within reason) or find any bugs,
  254.     please let me know.
  255.  
  256.     Don Messerli
  257.     CompuServe    72500,1671
  258.     GEnie        DMESS
  259.  
  260.     Legal Obligations
  261.     -----------------
  262.     
  263.     MacPaint is a registered trademark of Apple Corp. and
  264.     Claris Corporation
  265.  
  266.     GIF is a trademark of CompuServe Incorporated, an H&R Block
  267.     Company.
  268.  
  269.     Atari, Portfolio, the Fuji logo, and Portfolio logo are
  270.     all registered trademarks of Atari Corp.
  271.     
  272.     Microsoft is a registered trademark of Microsoft Corporation.
  273.  
  274.     Print Shop and The New Print Shop are registered trademarks 
  275.     of Broderbund.
  276.  
  277. ə